home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 5 / QRZ Ham Radio Callsign Database - Volume 5.iso / files / packet / baycom / 4thbyap.exe / BYAP.DOC < prev    next >
Encoding:
Text File  |  1993-02-20  |  10.1 KB  |  251 lines
  1.           I have added all calls that have given any kind of feedback
  2.           from previous versions as list of "registred" users. (All that
  3.           I have been able to track having a "home bbs" by messages that
  4.           I have saved, there might be some missing ones).
  5.           Information of this release have been sent to them as private
  6.           message (should be there ages before @ww bulletin!).
  7.  
  8.           I'll thank all of you very much. Because of this feedback I have
  9.           now produced this new version, otherwise it might not have been
  10.           done.
  11.           I hope there are no (big :-) ) bugs. Anyway, save the old version
  12.           while testing this one. I was also usefull one.
  13.  
  14.           It might be that there will be new Baycom out with Yapp soon. In
  15.           that case this will be the last version, otherwise I'll continue
  16.           developing these programs (if I receive some feedback)
  17.  
  18.  
  19.  
  20. What is new ?                                  17-02-1993
  21.  
  22.  ByapC v1.3
  23.  ByapT v2.1
  24.  
  25.  
  26.  
  27.         - when file to be sent was on different drive (I.E. A:file.exe)
  28.           the drive and path was added to yapp.snd causing an incorrect
  29.           YPUT parameter for bbs. Now only the name is transferred to
  30.           yapp.snd. (ByapT)
  31.  
  32.         - when requested file is not found and DIR_MASK has been given
  33.           and directory list executed will now ask:
  34.  
  35.                 "ESC to end program"
  36.  
  37.           previously CTRL+BREAK did not work on all machines. ESC works,
  38.           I hope so.....(ByapT and ByapC)
  39.  
  40.  
  41.         - added config file where you can tell where to keep temoporary
  42.           YAPP.* files. NOTE ! You have to set SCC.INI macros to point
  43.           to SAME drive/subdir as here. And remember: You CAN NOT use
  44.           C:\BAY\FILE\ with ST macros ! Instead USE C:/BAY/FILE/ it
  45.           is accepted.(ByapT and ByapC)
  46.  
  47.           In same config file you can point drive and path for competely
  48.           correct decoded file (ByapC).
  49.  
  50.           Both drives/subdirs are tested at programs begin. If test
  51.           fails current drive and path is used instead.
  52.           Detection cant clear out if floppy is missing and path is
  53.           given to floppy's root directory. In that case error will
  54.           be created ("cant open") when program tries to write empty
  55.           floppy station.
  56.  
  57.           Also upload command , default YPUT, and description line
  58.           exist/not exist, default exist, can be defined in BYAP.CFG
  59.           for YAPP.SND file (ByapT)
  60.  
  61.  
  62.         - it was bossible to add old YAPP.IN to YAPP.BRK (resume case).
  63.           To prevent these accidents ByapC will now ALWAYS rename input
  64.           file (what ever it is, mostly YAPP.IN) to same name and extension
  65.           ".BAK". This is done no matter if decoding was succesfull or not.
  66.           If there is  file using same name and extension BAK it will be
  67.           deleted before rename. (as EDLIN and most editors do....)
  68.           (ByapC)
  69.  
  70.         - Input file name can NOT contain characters "*" and/or "?"
  71.           (ByapC ans ByapT)
  72.           and extension can NOT be ".BAK"
  73.           (ByapC )
  74.  
  75.         - ByapC (S)tandard function did fail with some other BBSes than
  76.           FBB because different header (than descripted in Rev 1.1 Yapp
  77.           document of WA7MBL 06/23/86).
  78.           Now header detection routine has been rewritten. I hope it can
  79.           now detect those "other-than-fbb" headers as well as FBB ones
  80.           (ByapC)
  81.  
  82.         - it was bossible to decode YappC capture using (S)tandard. This
  83.           was bossible because poor data-block detection.(maybe it was
  84.           rather good anyway...hi).
  85.           Now block detection is better and attempt to decode YappC with
  86.           (S)tandard gives error.
  87.           (ByapC)
  88.  
  89.         - disk read and write errors (disk full) are now better detected
  90.           and reported.
  91.           (ByapT and ByapC)
  92.  
  93.  
  94.                         ----------------------------------
  95.  
  96.  
  97.   BYAPC v1.2                                    OH1KH @ OH1RBF.FIN.EU
  98. & BYAPT v2.0                                          @ UO22
  99.  
  100.                                                 20-01-1993
  101.  
  102.  
  103.   Here are the latest versions of Baycom Yapp receive and transmit processing
  104.   files.
  105.  
  106.   Some bugs have been corrected (thanks for reports!), some may still remain.
  107.   I'll hope not, but......
  108.  
  109.   Both programs are now designed so that they are able to work from Baycom's
  110.   DOS-SHELL (:o). This, with keyboard macros, is making Yapp transfers nearly
  111.   as easy as the feature would be "built-in".
  112.  
  113.   Note that you may place these programs in any subdir you wish, as long as
  114.   also incoming and outgoing data is directed to same subdir. Of course
  115.   ST-macros have to be corrected to point right subdir.
  116.  
  117.   Both programs give short help (with ?) mainly how to operate Yapping
  118.   manually. How ever ST macros should be used in every case. This saves
  119.   lot of typing.
  120.  
  121.   ---------RX:---------
  122.   Go to FBBDOS and give command YGET FILENAME. BBS will answer " Ready to
  123.   send FILENAME with ........".
  124.  
  125.   At this point press ALT-A.
  126.   Capture is opened and start chrs are sent to BBS. Look at byte
  127.   counter on right side, bottom statusline.
  128.   When this counter gets nearly same value as FILENAME length was, look
  129.   for the last characters from BBS. They should be ^C^A (inverse or
  130.   different color meaning they are controls.)
  131.  
  132.   When ^C^A has been received, press ALT-S.
  133.  
  134.   Capture is closed and ByapC is started (Dos-shell). It defaults to
  135.   YAPP.IN capture filename. If that is OK just press enter. Otherwise
  136.   give an other name.
  137.   Next question is protocol. If your ST-macro sends ^F^A^F^F with ALT-A
  138.   give "C" here for YappC. If the macro sends ^F^A^F^B, give "S" for
  139.   standard Yapp. It is recommended ALWAYS to use YappC when bossible.
  140.  
  141.   If your YAPP.IN holds data from RESUME  give "J" for joining resume data
  142.   to previously received data. Resume works ONLY with YappC !
  143.  
  144.   --RESUME---
  145.   When you have entered one of those 3 letters ByapC will start decoding.
  146.   If any errors are detected (and YappC used) it will create YAPP.ERR
  147.   and YAPP.BRK files.
  148.   In this case , when back in FBBDOS, give same YGET FILENAME again to
  149.   request resume for corrupted file. When BBS says "Ready to send....."
  150.   Do NOT press ALT -A !"
  151.   INSTEAD OF THAT PRESS ALT-D !! Immediately (1sec) after that press
  152.   ENTER.
  153.   This ALT-D will send first resume request from file YAPP.ERR. After
  154.   ENTER is pressed new capture is opened. If this happens too late
  155.   header information is lost, and capture is useless. Then try again.
  156.  
  157.   Again, when data transfer ends (^C^A as last chrs). Press ALT-S as
  158.   usually. Capture is closed and ByapC is started.
  159.   Now give filename(or Yapp.in for default) and THEN PRESS "J" for
  160.   joining data.
  161.   If all goes OK, file is ready. Otherwise new YAPP.ERR and YAPP.BRK
  162.   are created for next try.
  163.  
  164. --------------TX:-----------------
  165.  
  166.   Yapp transmit is supported only as standard Yapp.
  167.  
  168.   Go to FBBDOS. Select upload directory.
  169.   Press ALT-Q, BYAPT is started asking file name to transmit.
  170.   Give the name and description (max 40chr) and ByapT will process file
  171.   for transmit to YAPP.OUT. File YAPP.SND holds commands YPUT FILENAME and
  172.   DESCRIPTION LINE. YAPP.HEA holds the header info of file.
  173.  
  174.   When BYAPT finishes, YAPP.SND will be sent via same ALT-Q macro.
  175.   BBS will reply "Ready to receive....."
  176.  
  177.   Then press ALT-W to send transfer start characters.
  178.   BBS will reply ^F^A
  179.  
  180.   At that point press ALT-W to send header info.
  181.   When it has gone BBS  will send ^F^F
  182.  
  183.   Then press ALT-R to send YAPP.OUT, the data of file. Look after transfer.
  184.   If "Abort" with some control chars appear while transfer is still going
  185.   on, close buffer (:WPRG OFF) and start from beginning.
  186.  
  187.   When all data has gone BBS will send ^F^D.
  188.   Then press ALT-T to terminate Yapp transfer.
  189.  
  190. -----------------------------------
  191.  
  192.   That's all. Rather easy, isn't it. Here you will have a proposal
  193.   for your ST-MACRO definitions. Add this to your SCC.INI file
  194.   with necassary modifications.
  195.  
  196.  
  197.  
  198.     Happy Yapping !
  199.  
  200.     73'Saku  OH1KH
  201.  
  202.  
  203.  
  204.  
  205. ; Definition of the Standard Texts.
  206. ; --------------------------------
  207. ; proposal, make your own changes as needed !
  208. ;--------------------------------------------
  209. ;
  210. ;                       YAPPC Start RX1  --> reply to ^E^A   (alt-a)
  211. st a0 \x:paclen 4      ;set paclen to 4 for next transmission
  212. st a1 wprg yapp.in     ;open capture "YAPP.IN"
  213. st a2 \x           ;send ^F^A^F^F (For YappC, ^F^A^F^B for standard)
  214. ;
  215. ;                       YAPPC stop RX2 --> reply to ^C^A   (alt-s)
  216. st s0 \x             ;send ^F^D
  217. st s1 \x:wprg off      ;close capture
  218. st s2 pacl 230         ;set paclen to normal
  219. st s3 \x\rbug          ;send dummy cmd to fbb to break looping (perhaps)
  220. st s4 \x:o BYAPC       ;goto DOS-shell for ByapC process.
  221. st s5 \x               ;clean line
  222. ;
  223. ;                       YAPPC resume  --> reply to ^E^A (alt-d)
  224. st d0 :rprg yapp.err   ;send received info + request to resume
  225. st d1 :wprg yapp.in\i  ;open capture "YAPP.IN"
  226. ;
  227. ;--------------------------------------------------------
  228. ;
  229. ;                       YAPP TX1 --> prepare file + send YPUT+info (alt-q)
  230. st q0 \x:o byapt       ;prepare outgoing file in DOS-shell with Byapt
  231. st q1 \x:paclen 230    ;set paclen to normal
  232. st q2 r yapp.snd       ;send yapp request and file info
  233. ;
  234. ;
  235. ;                       YAPP TX2 --> reply to "Ready to recei...." (alt-w)
  236. st w1 paclen 2         ;set paclen to 2 for next transmission
  237. st w2 \x             ;send ^E^A
  238. ;
  239. ;                       YAPP TX3 --> reply to ^F^A  (send header)   (alt-e)
  240. st e0 \x:paclen 230    ;set paclen to normal
  241. st e1 rprg yapp.hea    ;send header info
  242. ;
  243. ;                       YAPP TX4 --> reply to ^F^B (send file)  (alt-r)
  244. st r \x:rprg yapp.out  ;send prepared data file
  245. ;
  246. ;                       YAPP TX5 --> reply to ^F^C (send end_of_tx) (alt t)
  247. st t0 \x:paclen 2      ;set paclen to 2 for next transmission
  248. st t1 \x             ;send ^D^A
  249. st t2 \x:paclen 230    ;set paclen to normal
  250. st t3 \x\rbug          ;send dummy cmd to fbb to break looping (perhaps)
  251.